home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / gllinewidth.z / gllinewidth
Encoding:
Text File  |  2001-04-17  |  7.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh - specify the width of rasterized lines
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh( GLfloat _w_i_d_t_h )
  14.  
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _w_i_d_t_h  Specifies the width of rasterized lines.  The initial value is 1.
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      ggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh specifies the rasterized width of both aliased and
  21.      antialiased lines.  Using a line width other than 1 has different
  22.      effects, depending on whether line antialiasing is enabled.  To enable
  23.      and disable line antialiasing, call ggggllllEEEEnnnnaaaabbbblllleeee and ggggllllDDDDiiiissssaaaabbbblllleeee with argument
  24.      GGGGLLLL____LLLLIIIINNNNEEEE____SSSSMMMMOOOOOOOOTTTTHHHH. Line antialiasing is initially disabled.
  25.  
  26.      If line antialiasing is disabled, the actual width is determined by
  27.      rounding the supplied width to the nearest integer.  (If the rounding
  28.      results in the value 0, it is as if the line width were 1.)  If
  29.      |Wx| _> |Wy|, _i pixels are filled in each column that is rasterized, where
  30.      _i is the rounded value of _w_i_d_t_h.  Otherwise, _i pixels are filled in each
  31.      row that is rasterized.
  32.  
  33.      If antialiasing is enabled, line rasterization produces a fragment for
  34.      each pixel square that intersects the region lying within the rectangle
  35.      having width equal to the current line width, length equal to the actual
  36.      length of the line, and centered on the mathematical line segment.  The
  37.      coverage value for each fragment is the window coordinate area of the
  38.      intersection of the rectangular region with the corresponding pixel
  39.      square.  This value is saved and used in the final rasterization step.
  40.  
  41.      Not all widths can be supported when line antialiasing is enabled. If an
  42.      unsupported width is requested, the nearest supported width is used.
  43.      Only width 1 is guaranteed to be supported; others depend on the
  44.      implementation.  Likewise, there is a range for aliased line widths as
  45.      well.  To query the range of supported widths and the size difference
  46.      between supported widths within the range, call ggggllllGGGGeeeetttt with arguments
  47.      GGGGLLLL____AAAALLLLIIIIAAAASSSSEEEEDDDD____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____RRRRAAAANNNNGGGGEEEE, GGGGLLLL____SSSSMMMMOOOOOOOOTTTTHHHH____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____RRRRAAAANNNNGGGGEEEE,
  48.      GGGGLLLL____SSSSMMMMOOOOOOOOTTTTHHHH____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____GGGGRRRRAAAANNNNUUUULLLLAAAARRRRIIIITTTTYYYY.
  49.  
  50. NNNNOOOOTTTTEEEESSSS
  51.      The line width specified by ggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh is always returned when
  52.      GGGGLLLL____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH is queried.  Clamping and rounding for aliased and
  53.      antialiased lines have no effect on the specified value.
  54.  
  55.      Nonantialiased line width may be clamped to an implementation-dependent
  56.      maximum.  Call ggggllllGGGGeeeetttt with GGGGLLLL____AAAALLLLIIIIAAAASSSSEEEEDDDD____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____RRRRAAAANNNNGGGGEEEE to determine the
  57.      maximum width.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh((((3333GGGG))))
  71.  
  72.  
  73.  
  74. EEEERRRRRRRROOOORRRRSSSS
  75.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h is less than or equal to 0.
  76.  
  77.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh is executed between the
  78.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  79.  
  80. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  81.      ggggllllGGGGeeeetttt with argument GGGGLLLL____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH
  82.      ggggllllGGGGeeeetttt with argument GGGGLLLL____AAAALLLLIIIIAAAASSSSEEEEDDDD____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____RRRRAAAANNNNGGGGEEEE
  83.      ggggllllGGGGeeeetttt with argument GGGGLLLL____SSSSMMMMOOOOOOOOTTTTHHHH____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____RRRRAAAANNNNGGGGEEEE
  84.      ggggllllGGGGeeeetttt with argument GGGGLLLL____SSSSMMMMOOOOOOOOTTTTHHHH____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____GGGGRRRRAAAANNNNUUUULLLLAAAARRRRIIIITTTTYYYY
  85.      ggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____LLLLIIIINNNNEEEE____SSSSMMMMOOOOOOOOTTTTHHHH
  86.  
  87.  
  88. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  89.      IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy systems do not support antialiased lines in color-index
  90.      rendering contexts.  (They are rendered as ordinary lines instead.)
  91.  
  92.  
  93. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  94.      ggggllllBBBBlllleeeennnnddddFFFFuuuunnnncccc, ggggllllEEEEnnnnaaaabbbblllleeee, ggggllllHHHHiiiinnnntttt
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.